docs: Add gtk-doc notation

to emphasize that GtkMisc and GtkAdjustment are not encouraged in new code

diff --git a/docs/reference/gtk/tmpl/gtkmisc.sgml b/docs/reference/gtk/tmpl/gtkmisc.sgml
index 57ab5c70904e51347dcffab11de3d247af7d0c15..c9016e2b0fc4775f0bfc576cddd2d5cd5e50d657 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkmisc.sgml
+++ b/docs/reference/gtk/tmpl/gtkmisc.sgml
@@ -19,11 +19,13 @@ positioned within its allocated area. Note that if the widget is added to
 a container in such a way that it expands automatically to fill its
 allocated area, the alignment settings will not alter the widgets position.
 </para>
+<note>
 <para>
 Note that the desired effect can in most cases be achieved by using the
 #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties
 on the child widget, so GtkMisc should not be used in new code.
 </para>
+</note>
 
 <!-- ##### SECTION See_Also ##### -->
 <para>

diff --git a/gtk/gtkalignment.c b/gtk/gtkalignment.c
index b3e0b85c79a4940e3ef3546003a7233345e8cb00..d8b3fec5704210d48d84d416e3f741d0bb416887 100644 (file)
--- a/gtk/gtkalignment.c
+++ b/gtk/gtkalignment.c
@@ -42,9 +42,13 @@
  * Of course, if the scale settings are both set to 1, the alignment settings
  * have no effect.
  *
+ * <note>
+ * <para>
  * Note that the desired effect can in most cases be achieved by using the
  * #GtkWidget:halign, #GtkWidget:valign and #GtkWidget:margin properties
  * on the child widget, so #GtkAlignment should not be used in new code.
+ * </para>
+ * </note>
  */
 
 #include "config.h"